ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

A File Icon

by ihodev, DeathAxe ST3 Top 25

Sublime Text File-Specific Icons for Improved Visual Grepping

Labels theme, file, icons

Details

  • 4.0.1
    3.33.9
  • github.​com
  • github.​com
  • 2 weeks ago
  • 5 hours ago
  • 10 years ago

Installs

  • Total 1.35M
  • Win 795K
  • Mac 290K
  • Linux 268K
Oct 28 Oct 27 Oct 26 Oct 25 Oct 24 Oct 23 Oct 22 Oct 21 Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13
Windows 39 46 41 38 39 47 47 70 62 43 34 31 62 49 52 52 71 44 38 69 56 47 49 71 36 31 59 33 55 53 47 40 27 62 58 56 73 52 39 40 56 75 66 47 57 29
Mac 12 23 27 15 15 17 23 28 37 22 16 24 17 22 35 30 36 10 24 27 27 29 20 15 9 15 19 12 25 24 28 21 11 33 28 24 33 45 19 10 22 25 29 31 30 15
Linux 17 29 16 22 11 24 18 29 22 13 18 21 18 25 16 21 26 26 23 26 20 20 17 16 15 14 11 19 17 20 15 26 25 15 26 17 27 24 25 25 17 20 21 34 32 20

Readme

Source
raw.​githubusercontent.​com

A File Icon

preview

Star on GitHub Join the chat at Sublime Forum

This Sublime Text package …

  1. provides basic infrastructure to select and customize file icon themes.
  2. ships colored and monochrome file icons, heavily inspired by Atom File Icons.

Installation

Package Control

The easiest way to install is using Sublime's Package Control. It's listed as A File Icon.

  1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
  2. Run Package Control: Install Package
  3. Find A File Icon and hit Enter

Manual Install

  1. Download AFileIcon.sublime-package
  2. Rename it to A File Icon.sublime-package
  3. Copy it into Installed Packages directory

[!NOTE]

To find Installed Packages…

  1. call Menu > Preferences > Browse Packages..
  2. Navigate to parent folder

Usage

Select Icon Theme

  1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
  2. Run UI: Select Icon Theme
  3. Choose a theme and hit Enter

Customize Icon Theme

  1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
  2. Run UI: Customize Icon Theme
  3. Choose a theme and hit Enter

An icon theme maps file extension to image names in the following format:

{
    "icons": {
        "extension": "icon_file_name",
    }
}

Customize Icon Settings

To change color, opacity level and size of icons, modify A File Icon settings:

  1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
  2. Run Preferences: A File Icon Settings

[!NOTE]

Settings are applied globally to all icon themes.

Theme Developers

As of Sublime Text 4206 dedicated icon themes are supported, which A File Icon 4.0 relies on.

A side effect is it no longer merging its icons into those shipped with themes.

Ideally, icon themes are deployed by dedicated packages to fully separate them from themes or color schemes.

If theme packages ship icons, a related .sublime-file-icons file is to be defined for them to be selectable by end users.

The .supports-a-file-icon-customization is still evaluated to decide how to create icon related theme patches as former versions of A File Icons did.

Resources

Colors

Colors are bright because they should look good with most themes. However you can change color and opacity level of all icons. See customization.

Palette

Icons

This package contains icons provided by:

Source icons are provided in SVG format (Sublime Text doesn't currently support it). They are convert to @1x and @2x PNG assets before each release via python build script uv run build --icons.

Rasterized icons can be found in icons folder.